home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pminfo.z / pminfo
Text File  |  1997-04-03  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMIIIINNNNFFFFOOOO((((1111))))                                                            PPPPMMMMIIIINNNNFFFFOOOO((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmiiiinnnnffffoooo - display information about performance metrics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmiiiinnnnffffoooo [----ddddffffFFFFMMMMmmmmTTTTttttvvvvzzzz] [----aaaa _a_r_c_h_i_v_e] [----bbbb _b_a_t_c_h_s_i_z_e] [----hhhh _h_o_s_t_n_a_m_e] [----nnnn
  13.      _n_a_m_e_s_p_a_c_e] [----OOOO _t_i_m_e] [----ZZZZ _t_i_m_e_z_o_n_e] [_m_e_t_r_i_c_n_a_m_e ...]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmiiiinnnnffffoooo displays various types of information about performance metrics
  17.      available through the facilities of the Performance Co-Pilot (PCP).
  18.  
  19.      Normally ppppmmmmiiiinnnnffffoooo operates on the default Performance Metrics Namespace
  20.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  21.      loaded from the file _n_a_m_e_s_p_a_c_e.  Independent of the ----nnnn option, the
  22.      namespace is always local to machine on which ppppmmmmiiiinnnnffffoooo is run.
  23.  
  24.      The metrics of interest are named in the _m_e_t_r_i_c_n_a_m_e arguments.  If
  25.      _m_e_t_r_i_c_n_a_m_e is a non-leaf node in the namespace (see ppppmmmmnnnnssss(4)), then ppppmmmmiiiinnnnffffoooo
  26.      will recursively descend the PMNS and report on all leaf nodes.  If no
  27.      _m_e_t_r_i_c_n_a_m_e argument is given, the root if the namespace is used.
  28.  
  29.      Unless directed to another host by the ----hhhh option, ppppmmmmiiiinnnnffffoooo will contact the
  30.      Performance Metrics Collector Daemon (PMCD) on the local host.  The
  31.      connection to a PMCD is only required if ppppmmmmiiiinnnnffffoooo requires meta-data
  32.      describing metrics, and/or metric values, and/or help text.
  33.  
  34.      The ----aaaa option causes ppppmmmmiiiinnnnffffoooo to use the specified archive rather than
  35.      connecting to a PMCD.  The ----aaaa and ----hhhh options are mutually exclusive.
  36.  
  37.      The ----bbbb option may be used to define the maximum size of the group of
  38.      metrics to be fetched in a single request for the ----ffff and ----vvvv options.  The
  39.      default batchsize is 20.
  40.  
  41.      Other options control the specific information to be reported.
  42.  
  43.      ----dddd   Metric descriptions detailing the PMID, data type, data semantics,
  44.           units, scale and associated instance domain.
  45.  
  46.      ----ffff   Fetch and print values for all instances.  When fetching from an
  47.           archive, only those instances present in the first archive record
  48.           for a metric will be displayed; see also the ----OOOO option, else use
  49.           ppppmmmmdddduuuummmmpppplllloooogggg(1) which may be a better tool for examining archives.
  50.  
  51.      ----FFFF   Same as ----ffff but try harder to fetch instances for metrics which have
  52.           non-enumerable instance domains (e.g. metrics in the ``proc''
  53.           subtree of the default namespace).
  54.  
  55.      ----mmmm   Print the PMID in terse mode.
  56.  
  57.      ----MMMM   Print the PMID in verbose mode.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMIIIINNNNFFFFOOOO((((1111))))                                                            PPPPMMMMIIIINNNNFFFFOOOO((((1111))))
  71.  
  72.  
  73.  
  74.      ----OOOO   When used in conjunction with an archive source of metrics and the
  75.           options ----ffff or ----FFFF, the _t_i_m_e argument defines a time origin at which
  76.           the metrics should be fetched from the archive.  Refer to
  77.           ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3) for a complete description of this option, and
  78.           the syntax for the _t_i_m_e argument.
  79.  
  80.           When the ``ctime'' format is used for the _t_i_m_e argument in a ----OOOO
  81.           option, the timezone becomes an issue.  The default is to use the
  82.           local timezone on the system where ppppmmmmiiiinnnnffffoooo is run.  The ----ZZZZ option
  83.           changes the timezone to _t_i_m_e_z_o_n_e in the format of the environment
  84.           variable TTTTZZZZ as described in eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the
  85.           timezone to the local timezone at the host that is the source of the
  86.           performance metrics, as identifed via the ----aaaa option.
  87.  
  88.      ----tttt   Print the ``one line'' help summary, if available.
  89.  
  90.      ----TTTT   Print the help text, if available.
  91.  
  92.      ----vvvv   Verify mode in which descriptions and values are retrieved, but only
  93.           error conditions are reported.  This option silently disables any
  94.           output from the options ----ffff, ----MMMM, ----mmmm, ----tttt and ----TTTT.
  95.  
  96. FFFFIIIILLLLEEEESSSS
  97.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmpppprrrroooobbbbeeee(1), PPPPMMMMAAAAPPPPIIII(3),
  101.      ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3) and ppppmmmmnnnnssss(4).
  102.  
  103. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         PPPPaaaaggggeeee 2222
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.